home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / symlink.z / symlink
Encoding:
Text File  |  1998-10-20  |  7.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ssssyyyymmmmlllliiiinnnnkkkk((((2222))))                                                          ssssyyyymmmmlllliiiinnnnkkkk((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_yyyy_mmmm_llll_iiii_nnnn_kkkk - make a symbolic link to a file
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _ssss_yyyy_mmmm_llll_iiii_nnnn_kkkk_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_nnnn_aaaa_mmmm_eeee_1111_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_nnnn_aaaa_mmmm_eeee_2222_))));
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _ssss_yyyy_mmmm_llll_iiii_nnnn_kkkk creates a symbolic link _n_a_m_e_2 to the file _n_a_m_e_1.  Either name may
  18.      be an arbitrary pathname, the files need not be on the same file system,
  19.      and _n_a_m_e_1 may be nonexistent.
  20.  
  21.      The file to which the symbolic link points is used when an _oooo_pppp_eeee_nnnn(2)
  22.      operation is performed on the link.  A _ssss_tttt_aaaa_tttt(2) on a symbolic link returns
  23.      the linked-to file, while an _llll_ssss_tttt_aaaa_tttt returns information about the link
  24.      itself.  This can lead to surprising results when a symbolic link is made
  25.      to a directory.  To avoid confusion in programs, the _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk(2) call can
  26.      be used to read the contents of a symbolic link.
  27.  
  28.      If the file named by _n_a_m_e_2 does not exist, it is created.  The permission
  29.      mode of _n_a_m_e_2 is 777 [see _cccc_rrrr_eeee_aaaa_tttt(2)].
  30.  
  31.      Control checks depend on the security level of the referenced file when
  32.      following a symbolic link, while the level of the symbolic link is
  33.      ignored.
  34.  
  35.      The symbolic link is made unless one or more of the following are true:
  36.  
  37.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Search permission is denied for a component of the
  38.                          path prefix of _n_a_m_e_2.
  39.  
  40.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Write access is denied on the directory in which the
  41.                          new file is to be created.
  42.  
  43.      _EEEE_DDDD_QQQQ_UUUU_OOOO_TTTT              The directory in which the entry for the new symbolic
  44.                          link is being placed cannot be extended because the
  45.                          user's quota of disk blocks on the file system
  46.                          containing the directory has been exhausted.
  47.  
  48.      _EEEE_DDDD_QQQQ_UUUU_OOOO_TTTT              The new symbolic link cannot be created because the
  49.                          user's quota of disk blocks on the file system which
  50.                          will contain the link has been exhausted.
  51.  
  52.      _EEEE_DDDD_QQQQ_UUUU_OOOO_TTTT              The user's quota of inodes on the file system on
  53.                          which the file is being created has been exhausted.
  54.  
  55.      _EEEE_EEEE_XXXX_IIII_SSSS_TTTT              The file referred to by _n_a_m_e_2 already exists.
  56.  
  57.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT              _n_a_m_e_1 or _n_a_m_e_2 points outside the allocated address
  58.                          space for the process.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssyyyymmmmlllliiiinnnnkkkk((((2222))))                                                          ssssyyyymmmmlllliiiinnnnkkkk((((2222))))
  71.  
  72.  
  73.  
  74.      _EEEE_IIII_OOOO                 An I/O error occurs while reading from or writing to
  75.                          the file system.
  76.  
  77.      _EEEE_LLLL_OOOO_OOOO_PPPP               Too many symbolic links are encountered in
  78.                          translating _n_a_m_e_2.
  79.  
  80.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG        The length of the _n_a_m_e_1 or _n_a_m_e_2 argument exceeds
  81.                          {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX}, or the length of a _n_a_m_e_1 or _n_a_m_e_2
  82.                          component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX} while (______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC)
  83.                          is in effect.
  84.  
  85.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              A component of the path prefix of _n_a_m_e_2 does not
  86.                          exist.
  87.  
  88.      _EEEE_NNNN_OOOO_SSSS_PPPP_CCCC              The directory in which the entry for the new symbolic
  89.                          link is being placed cannot be extended because no
  90.                          space is left on the file system containing the
  91.                          directory.
  92.  
  93.      _EEEE_NNNN_OOOO_SSSS_PPPP_CCCC              The new symbolic link cannot be created because no
  94.                          space is left on the file system which will contain
  95.                          the link.
  96.  
  97.      _EEEE_NNNN_OOOO_SSSS_PPPP_CCCC              There are no free inodes on the file system on which
  98.                          the file is being created.
  99.  
  100.      _EEEE_NNNN_OOOO_SSSS_YYYY_SSSS              The file system does not support symbolic links
  101.  
  102.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR             A component of the path prefix of _n_a_m_e_2 is not a
  103.                          directory.
  104.  
  105.      _EEEE_RRRR_OOOO_FFFF_SSSS               The file _n_a_m_e_2 would reside on a read-only file
  106.                          system.
  107.  
  108. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  109.      Upon successful completion _ssss_yyyy_mmmm_llll_iiii_nnnn_kkkk returns a value of 0; otherwise, it
  110.      returns -1 and places an error code in _eeee_rrrr_rrrr_nnnn_oooo.
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      _cccc_pppp(1), _llll_iiii_nnnn_kkkk(2), _rrrr_eeee_aaaa_dddd_llll_iiii_nnnn_kkkk(2), _uuuu_nnnn_llll_iiii_nnnn_kkkk(2), _rrrr_eeee_aaaa_llll_pppp_aaaa_tttt_hhhh(3C)
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.